home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / pmp232.zip / PMP.DOC < prev    next >
Text File  |  1993-10-10  |  12KB  |  249 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.      ──────────────────────────────────────────────────────────────────────
  9.      Protected Module Player PMP (C) 1993 Jussi Lahdenniemi and Otto Chrons
  10.      ──────────────────────────────────────────────────────────────────────
  11.  
  12.                                   Version 2.31
  13.  
  14.  
  15.  
  16.  
  17.  
  18.         Like the DMP, also PMP is just a demonstration about the possibilities
  19.      of the DSMI (Digital Sound and Music Interface). It is a module player,
  20.      which runs in the protected mode, offering lots of memory for the modules
  21.      to use. Also, because of this, the PMP gives you a fully-working DOS
  22.      shell, and takes only about 40k of memory regardless of the size of
  23.      the module! So, you can play a 700k module and still have over 550k of
  24.      memory free! If your computer is in the v86-mode (ie. you have a program
  25.      like QEMM installed) the PMP takes a little more memory (24k more),
  26.      because the buffers must reside in the low memory.
  27.  
  28.         The command line syntax of the PMP is just the same as DMP's :
  29.  
  30.            PMP [options] [modulename] [@listfile] [options]
  31.  
  32.            Where:
  33.            ------
  34.        modulename : name of a module (wildcards *,? allowed)
  35.        listfile   : name of a file containing list of module names
  36.  
  37.        options  : -Sxxxx          set sampling rate 4000-44100
  38.                       alternatively 4-44
  39.                       DON'T USE HIGHER THAN 21kHz ON A SB
  40.               -H or -?          show help screen
  41.               -Ix          interrupt number
  42.               -Pxxx          port address
  43.               -Dx          DMA channel
  44.               -O          Scramble module order
  45.               -L          Inhibit looping
  46.                       -M              Mono mode (SB16 & PAS)
  47.               -Q          Quality mode (on 8-bit cards only)
  48.                       -Bx             Volume bar type: 0=off, 1=middle,
  49.                                                        2=top, 3=bottom
  50.                       -Cx             Desired card where x is:
  51.                     1 for Sound Blaster
  52.                     2 for Sound Blaster Pro
  53.                     3 for PAS+
  54.                     4 for PAS16
  55.                     5 for SB16
  56.                                         6 for Aria
  57.                                         7 for Windows SoundSystem
  58.                                         8 for Gravis Ultrasound
  59.                       -T[xxx]         Buffer size xxx (0-32000)
  60.                       -Fxxx           Force PMP to leave xxx kilobytes
  61.                                       of memory for the DOS shell
  62.                       -V              Force PMP to use its v86 mode support
  63.                                       (place the buffers to low memory)
  64.  
  65.         You may have to  give your soundcard's IRQ  number and/or
  66.      port address if PMP fails to find them. If you don't provide both
  67.      values then PMP will assume 220h for port address, and 7 for interrupt
  68.      number. Giving  wrong address  will hang  your machine,  but wrong
  69.      interrupt number only stops the playing after a second. The "/C"
  70.      option is useful if you want to use some other card, than the one PMP
  71.      automatically detects.
  72.  
  73.         You don't  have  to add  any extension  to  the name,  because the
  74.      program will try  extensions AMF, STM, MOD and  NST if it  doesn't find
  75.      the file. Note that you can supply many modulenames and list files, up
  76.      to the internal limit of 200 modulenames.
  77.  
  78.            Example:
  79.  
  80.        PMP beyond -s20 *.NST @goodmods
  81.  
  82.            goodmods is a text file containing following lines:
  83.            occ-san
  84.            stars
  85.            intro3
  86.  
  87.         PMP  will use  the  sampling  rate  of  20kHz  and  play following
  88.      modules: BEYOND.MOD,  OCC-SAN.STM, STARS.MOD, INTRO3.MOD  and all
  89.      .NST-files in the current directory.
  90.  
  91.         The above text was taken straight from the DMP's documentation. As you
  92.      can see: If you can use DMP, you can use PMP...
  93.  
  94.         Normally PMP uses all free XMS memory for its own purposes, but if you
  95.      want to save some XMS for other programs, use the environment variable
  96.      DPMIMEM:
  97.  
  98.      SET DPMIMEM=MAXMEM 1024
  99.  
  100.      limits the XMS use to one MB.
  101.  
  102.         Note : Borland's programs that run in the protected mode use also
  103.      this environment variable.
  104.  
  105.         Another supported environment variable is PMP. You can write your
  106.      preferred settings into the variable, so you don't have to write them
  107.      every time you start the program. For example, if you have the PMP
  108.      variable set as follows:
  109.  
  110.      SET PMP=/S30 /O C:\MODS\*.MOD
  111.  
  112.      and then you run PMP like this:
  113.  
  114.      PMP *.stm
  115.  
  116.      PMP will be started just like if you had written
  117.      PMP /S30 /O C:\MODS\*.MOD *.stm
  118.      from the command line.
  119.  
  120.  
  121.  !!!!   The included files RTM.EXE and DPMI16BI.OVL must be in the path!   !!!!
  122.  
  123.  
  124.                             Using PMP
  125.                             ---------
  126.  
  127.         There is a header in the top of the screen telling what program you
  128.      are using and other important info. In the right side of the screen
  129.      there is a big blue box with all the module names you have selected
  130.      in the command line. When a module is loaded into memory, it is marked.
  131.      That way it is easy to see which modules are to be played next, and
  132.      which modules are loaded. There is also a big brown box on the bottom
  133.      of the screen containing all the instruments used in the module.
  134.         The volume bars are made with palette, and they demand really lots
  135.      of CPU power. They flicker easily even in fast machines. I am sorry,
  136.      but buy a faster machine if the bars don't work.. ;)  - or press B.
  137.         After initializing everything it needs, PMP starts to load the first
  138.      module. After loading it, PMP starts to play the module and proceeds
  139.      with loading the next module. It loads as many modules as possible,
  140.      and then plays them from memory. If all the modules you selected do
  141.      not fit to the memory, PMP discards the module after playing it and
  142.      loads more modules. With the /F switch you can control the memory
  143.      allocation so that you always will have enough memory to shell to DOS.
  144.         While playing under PMP (not in the DOS shell), there is a status
  145.      bar just below the header text. This status bar shows the pattern
  146.      currently being played, the total number of patterns, the current row,
  147.      the master volume level, and indicators indicating which channels are
  148.      being played. It also helps you by telling that help is available by the
  149.      H key. The help screen that pops up as you press H is the same that the
  150.      /? or /H command line switch shows.
  151.  
  152.      Keys while the module is being played :
  153.  
  154.        Key        Meaning                              Also in DOS shell
  155.        ---        -------                              -----------------
  156.  
  157.        P          Pauses / resumes the module          alt-F11
  158.        N          Next module                          alt-F12
  159.        H,?        Help screen
  160.        D          DOS shell (with lots of memory!)
  161.        C          Clear the information screen
  162.        S          Toggle SB Pro stereo mode on/off
  163.        B          Toggle the volume bars
  164.        F1-F10     Set the master volume
  165.        +,-        Change the master volume one step    shift-F11, shift-F12
  166.        Left,Right Jump to next/previous pattern        ctrl-F11, ctrl-F12
  167.        Up,Down    Scroll module list window
  168.        1,2,..     Turn track n on/off
  169.        Alt+1,2,.. Turn track n+10 on/off
  170.        <,>        Slower/faster screen update rate.
  171.                   If the bars flicker, try slowing
  172.                   the rate down. The faster rate, the
  173.                   quicker you see everything coming to
  174.                   the screen.
  175.        (,)        Decrease/increase the number of the
  176.                   volume bars.
  177.  
  178.  
  179.  
  180.                          Contacting the authors
  181.                          ----------------------
  182.  
  183.        If you have questions or comments about the PMP or the Pascal version
  184.     of the DSMI, contact Jussi Lahdenniemi:
  185.  
  186.        ┌─────────────────────────────────────────────────────────────────────┐
  187.        │                                                                     │
  188.        │   By mail:                                                          │
  189.        │   ────────                                                          │
  190.        │                                                                     │
  191.        │            Jussi Lahdenniemi                                        │
  192.        │            Rautia                                                   │
  193.        │            SF-36420 Sahalahti                                       │
  194.        │            FINLAND                                                  │
  195.        │                                                                     │
  196.        │   Fidonet:                                                          │
  197.        │   ─────────                                                         │
  198.        │            2:221/105.7                                              │
  199.        │                                                                     │
  200.        │   InterNet:                                                         │
  201.        │   ──────────                                                        │
  202.        │            jlahd@clinet.fi                                          │
  203.        │                                                                     │
  204.        └─────────────────────────────────────────────────────────────────────┘
  205.  
  206.  
  207.  
  208.        To comment about the DMP or the C or ASM versions of the DSMI, contact
  209.     Otto Chrons :
  210.  
  211.        ┌─────────────────────────────────────────────────────────────────────┐
  212.        │                                                                     │
  213.        │   By mail:                                                          │
  214.        │   ────────                                                          │
  215.        │                                                                     │
  216.        │            Otto Chrons                                              │
  217.        │            Pyydyspolku 5                                            │
  218.        │            SF-36200 Kangasala                                       │
  219.        │            FINLAND                                                  │
  220.        │                                                                     │
  221.        │   Fidonet:                                                          │
  222.        │   ─────────                                                         │
  223.        │        2:221/105.10                         │
  224.        │                                                                     │
  225.        │   InterNet:                                                         │
  226.        │   ──────────                                                        │
  227.        │            c142092@cc.tut.fi (fastest method to contact)            │
  228.        │                                                                     │
  229.        └─────────────────────────────────────────────────────────────────────┘
  230.  
  231.  
  232.  
  233.  
  234.                              For programmers only
  235.                              --------------------
  236.  
  237.  
  238.            PMP was  created with  Borland Pascal 7.0 and  it is  based on
  239.  DSMI routines, so by ordering DSMI interface you could write programs
  240.  with similar capabilities. DSMI is a collection of  routines (for C and
  241.  Turbo/Borland Pascal) that allows programmers to play  modules in the
  242.  background, but unlike any other module player it also allows
  243.  simultaneous sound effects!! Up to 32 channels can be used which means
  244.  that you can have a module and sound effects playing in full stereo (on
  245.  cards which support stereo sound)! DSMI is available and the price is
  246.  270FMK (about $70). Packet includes full documentation (printed), OBJ
  247.  files & libraries for C version, TPUs for Pascal and also some of the
  248.  source code so you can modify the behaviour of DSMI. Stay tuned!
  249.